<!DOCTYPE html>
<html lang=zh>
<head>
    <meta charset="utf-8">
    
    <title>Spring Cloud系列五 之 服务网关 | 程序猿</title>
    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
    <meta name="description" content="本篇文章内容简单，但是没有前面的基础是很难理解的，所以推荐看Spring Cloud系列的其他四篇文章，代码实现简单，主要是利用Netflix中的Zuul组件，但是总结起来没有很长的架构师经验是很难深刻理解的，故本文总结内容翻译自程序猿DD Spring Cloud系列博文，所有内容本人都已经测试没有问题，再次非常感谢程序猿DD，的优秀博文分享。本篇文章和前面配置信息Server一样的风格，从提">
<meta property="og:type" content="article">
<meta property="og:title" content="Spring Cloud系列五 之 服务网关">
<meta property="og:url" content="http://yoursite.com/2017/01/11/Spring Cloud系列五 之 服务网关/index.html">
<meta property="og:site_name" content="程序猿">
<meta property="og:description" content="本篇文章内容简单，但是没有前面的基础是很难理解的，所以推荐看Spring Cloud系列的其他四篇文章，代码实现简单，主要是利用Netflix中的Zuul组件，但是总结起来没有很长的架构师经验是很难深刻理解的，故本文总结内容翻译自程序猿DD Spring Cloud系列博文，所有内容本人都已经测试没有问题，再次非常感谢程序猿DD，的优秀博文分享。本篇文章和前面配置信息Server一样的风格，从提">
<meta property="og:image" content="http://upload-images.jianshu.io/upload_images/4279695-1b4152ed420e9e72.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240">
<meta property="og:image" content="http://upload-images.jianshu.io/upload_images/4279695-0923d03d83d4beab.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240">
<meta property="og:image" content="http://upload-images.jianshu.io/upload_images/4279695-ae97a701c1bcc936.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240">
<meta property="og:updated_time" content="2017-02-24T15:49:28.000Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="Spring Cloud系列五 之 服务网关">
<meta name="twitter:description" content="本篇文章内容简单，但是没有前面的基础是很难理解的，所以推荐看Spring Cloud系列的其他四篇文章，代码实现简单，主要是利用Netflix中的Zuul组件，但是总结起来没有很长的架构师经验是很难深刻理解的，故本文总结内容翻译自程序猿DD Spring Cloud系列博文，所有内容本人都已经测试没有问题，再次非常感谢程序猿DD，的优秀博文分享。本篇文章和前面配置信息Server一样的风格，从提">
<meta name="twitter:image" content="http://upload-images.jianshu.io/upload_images/4279695-1b4152ed420e9e72.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240">
    

    
        <link rel="alternate" href="/" title="程序猿" type="application/atom+xml" />
    

    

    <link rel="stylesheet" href="/libs/font-awesome/css/font-awesome.min.css">
    <link rel="stylesheet" href="/libs/open-sans/styles.css">
    <link rel="stylesheet" href="/libs/source-code-pro/styles.css">

    <link rel="stylesheet" href="/css/style.css">

    <script src="/libs/jquery/2.1.3/jquery.min.js"></script>
    
    
        <link rel="stylesheet" href="/libs/lightgallery/css/lightgallery.min.css">
    
    
        <link rel="stylesheet" href="/libs/justified-gallery/justifiedGallery.min.css">
    
    
    
    


</head>

<body>
    <div id="container">
        <header id="header">
    <div id="header-main" class="header-inner">
        <div class="outer">
            <a href="/" id="logo">
                <i class="logo"></i>
                <span class="site-title">程序猿</span>
            </a>
            <nav id="main-nav">
                
                    <a class="main-nav-link" href="http://chinesszz.oschina.io/">主页</a>
                
                    <a class="main-nav-link" href="/archives">档案</a>
                
                    <a class="main-nav-link" href="/archives">分类</a>
                
                    <a class="main-nav-link" href="/archives">标签</a>
                
                    <a class="main-nav-link" href="/关于我">关于我</a>
                
            </nav>
            
                
                <nav id="sub-nav">
                    <div class="profile" id="profile-nav">
                        <a id="profile-anchor" href="javascript:;">
                            <img class="avatar" src="/css/images/avatar.png" />
                            <i class="fa fa-caret-down"></i>
                        </a>
                    </div>
                </nav>
            
            <div id="search-form-wrap">

    <form class="search-form">
        <input type="text" class="ins-search-input search-form-input" placeholder="搜索" />
        <button type="submit" class="search-form-submit"></button>
    </form>
    <div class="ins-search">
    <div class="ins-search-mask"></div>
    <div class="ins-search-container">
        <div class="ins-input-wrapper">
            <input type="text" class="ins-search-input" placeholder="想要查找什么..." />
            <span class="ins-close ins-selectable"><i class="fa fa-times-circle"></i></span>
        </div>
        <div class="ins-section-wrapper">
            <div class="ins-section-container"></div>
        </div>
    </div>
</div>
<script>
(function (window) {
    var INSIGHT_CONFIG = {
        TRANSLATION: {
            POSTS: '文章',
            PAGES: '页面',
            CATEGORIES: '分类',
            TAGS: '标签',
            UNTITLED: '(未命名)',
        },
        ROOT_URL: '/',
        CONTENT_URL: '/content.json',
    };
    window.INSIGHT_CONFIG = INSIGHT_CONFIG;
})(window);
</script>
<script src="/js/insight.js"></script>

</div>
        </div>
    </div>
    <div id="main-nav-mobile" class="header-sub header-inner">
        <table class="menu outer">
            <tr>
                
                    <td><a class="main-nav-link" href="http://chinesszz.oschina.io/">主页</a></td>
                
                    <td><a class="main-nav-link" href="/archives">档案</a></td>
                
                    <td><a class="main-nav-link" href="/archives">分类</a></td>
                
                    <td><a class="main-nav-link" href="/archives">标签</a></td>
                
                    <td><a class="main-nav-link" href="/关于我">关于我</a></td>
                
                <td>
                    
    <div class="search-form">
        <input type="text" class="ins-search-input search-form-input" placeholder="搜索" />
    </div>

                </td>
            </tr>
        </table>
    </div>
</header>

        <div class="outer">
            
                

<aside id="profile">
    <div class="inner profile-inner">
        <div class="base-info profile-block">
            <img id="avatar" src="/css/images/avatar.png" />
            <h2 id="name">刘鑫</h2>
            <h3 id="title">一个热爱生活喜欢技术的程序猿</h3>
            <span id="location"><i class="fa fa-map-marker"></i>shanghai, China</span>
            <a id="follow" target="_blank" href="https://github.com/lxchinesszz">关注我</a>
        </div>
        <div class="article-info profile-block">
            <div class="article-info-block">
                25
                <span>文章</span>
            </div>
            <div class="article-info-block">
                19
                <span>标签</span>
            </div>
        </div>
        
        <div class="profile-block social-links">
            <table>
                <tr>
                    
                    
                    <td>
                        <a href="https://github.com/lxchinesszz" target="_blank" title="github" class=tooltip>
                            <i class="fa fa-github"></i>
                        </a>
                    </td>
                    
                    <td>
                        <a href="/" target="_blank" title="twitter" class=tooltip>
                            <i class="fa fa-twitter"></i>
                        </a>
                    </td>
                    
                    <td>
                        <a href="/" target="_blank" title="facebook" class=tooltip>
                            <i class="fa fa-facebook"></i>
                        </a>
                    </td>
                    
                    <td>
                        <a href="/" target="_blank" title="dribbble" class=tooltip>
                            <i class="fa fa-dribbble"></i>
                        </a>
                    </td>
                    
                    <td>
                        <a href="http://weibo.com/u/5513970927?is_all=1" target="_blank" title="weibo" class=tooltip>
                            <i class="fa fa-weibo"></i>
                        </a>
                    </td>
                    
                    <td>
                        <a href="/" target="_blank" title="rss" class=tooltip>
                            <i class="fa fa-rss"></i>
                        </a>
                    </td>
                    
                </tr>
            </table>
        </div>
        
    </div>
</aside>

            
            <section id="main"><article id="Layout-Spring Cloud系列五 之 服务网关" class="article article-type-Layout" itemscope itemprop="blogPost">
    <div class="article-inner">
        
        
            <header class="article-header">
                
    
        <h1 class="article-title" itemprop="name">
            Spring Cloud系列五 之 服务网关
        </h1>
    

                
                    <div class="article-meta">
                        
    <div class="article-date">
        <i class="fa fa-calendar"></i>
        <a href="/2017/01/11/Spring Cloud系列五 之 服务网关/">
            <time datetime="2017-01-10T16:00:00.000Z" itemprop="datePublished">2017-01-11</time>
        </a>
    </div>


                        
    <div class="article-category">
    	<i class="fa fa-folder"></i>
        <a class="article-category-link" href="/categories/Spring-Cloud/">Spring Cloud</a>
    </div>

                        
    <div class="article-tag">
        <i class="fa fa-tag"></i>
        <a class="tag-link" href="/tags/Spring-Cloud/">Spring Cloud</a>
    </div>

                    </div>
                
            </header>
        
        
        <div class="article-entry" itemprop="articleBody">
        
            
            <blockquote>
<p>本篇文章内容简单，但是没有前面的基础是很难理解的，所以推荐看Spring Cloud系列的其他四篇文章，代码实现简单，主要是利用Netflix中的Zuul组件，但是总结起来没有很长的架构师经验是很难深刻理解的，故本文总结内容翻译自程序猿DD Spring Cloud系列博文，所有内容本人都已经测试没有问题，再次非常感谢程序猿DD，的优秀博文分享。本篇文章和前面配置信息Server一样的风格，从提出问题开始，来带领大家一步一步解决问题，解决问题的过程成大家共学习，共成长希望对微服务架构感兴趣的童鞋，有所指引。</p>
</blockquote>
<p>通过之前翻译Spring Cloud组件的介绍，已经能够完成一个简单的微服务架构，大家脑子里都有一个大致的概念。这里通过一个图 描述一下。<br><img src="http://upload-images.jianshu.io/upload_images/4279695-1b4152ed420e9e72.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" alt="架构图"></p>
<p>Spring Cloud Netflix中的Eureka实现了服务注册中心以及服务注册与发现；而服务间通过Ribbon或Feign实现服务的消费以及均衡负载；通过Spring Cloud Config实现了应用多环境的外部化配置以及版本管理。为了使得服务集群更为健壮，使用Hystrix的融断机制来避免在微服务架构中个别服务出现异常时引起的故障蔓延。</p>
<p>在该架构中，我们的服务集群包含：内部服务Service A和Service B，他们都会注册与订阅服务至Eureka Server，而Open Service是一个对外的服务，通过均衡负载公开至服务调用方。本文我们把焦点聚集在对外服务这块，这样的实现是否合理，或者是否有更好的实现方式呢？</p>
<h5 id="先来说说这样架构需要做的一些事儿以及存在的不足："><a href="#先来说说这样架构需要做的一些事儿以及存在的不足：" class="headerlink" title="先来说说这样架构需要做的一些事儿以及存在的不足："></a>先来说说这样架构需要做的一些事儿以及存在的不足：</h5><ul>
<li>首先，破坏了服务无状态特点。为了保证对外服务的安全性，我们需要实现对服务访问的权限控制，而开放服务的权限控制机制将会贯穿并污染整个开放服务的业务逻辑，这会带来的最直接问题是，破坏了服务集群中REST API无状态的特点。从具体开发和测试的角度来说，在工作中除了要考虑实际的业务逻辑之外，还需要额外可续对接口访问的控制处理。</li>
<li>其次，无法直接复用既有接口。当我们需要对一个即有的集群内访问接口，实现外部服务访问时，我们不得不通过在原有接口上增加校验逻辑，或增加一个代理调用来实现权限控制，无法直接复用原有的接口。</li>
</ul>
<h5 id="下面进入本文的正题：服务网关！"><a href="#下面进入本文的正题：服务网关！" class="headerlink" title="下面进入本文的正题：服务网关！"></a>下面进入本文的正题：服务网关！</h5><p>为了解决上面这些问题，我们需要将权限控制这样的东西从我们的服务单元中抽离出去，而最适合这些逻辑的地方就是处于对外访问最前端的地方，我们需要一个更强大一些的均衡负载器，它就是本文将来介绍的：服务网关。</p>
<p>服务网关是微服务架构中一个不可或缺的部分。通过服务网关统一向外系统提供REST API的过程中，除了具备服务路由、均衡负载功能之外，它还具备了权限控制等功能。Spring Cloud Netflix中的Zuul就担任了这样的一个角色，为微服务架构提供了前门保护的作用，同时将权限控制这些较重的非业务逻辑内容迁移到服务路由层面，使得服务集群主体能够具备更高的可复用性和可测试性。</p>
<h2 id="问题汇总"><a href="#问题汇总" class="headerlink" title="问题汇总"></a>问题汇总</h2><ul>
<li>1.如何配置路由服务器</li>
<li><p>2.Zuul服务路由组件两种url映射关系配置</p>
<ul>
<li>2.1 url配置          <code>zuul.routes.api-a-url.url</code></li>
<li>2.2 serviceId配置    <code>zuul.routes.api-b.serviceId</code></li>
</ul>
</li>
<li>3.如何对路由服务器进行安全过滤措施</li>
<li>4.项目演示</li>
</ul>
<h3 id="问题1：如何配置路由服务器"><a href="#问题1：如何配置路由服务器" class="headerlink" title="问题1：如何配置路由服务器"></a>问题1：如何配置路由服务器</h3><p>引入依赖spring-cloud-starter-zuul、spring-cloud-starter-eureka，如果不是通过指定serviceId的方式，eureka依赖不需要，但是为了对服务集群细节的透明性，还是用serviceId来避免直接引用url的方式吧。</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div><div class="line">6</div><div class="line">7</div><div class="line">8</div></pre></td><td class="code"><pre><div class="line">&lt;dependency&gt;</div><div class="line">    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;</div><div class="line">    &lt;artifactId&gt;spring-cloud-starter-zuul&lt;/artifactId&gt;</div><div class="line">&lt;/dependency&gt;</div><div class="line">&lt;dependency&gt;</div><div class="line">    &lt;groupId&gt;org.springframework.cloud&lt;/groupId&gt;</div><div class="line">    &lt;artifactId&gt;spring-cloud-starter-eureka&lt;/artifactId&gt;</div><div class="line">&lt;/dependency&gt;</div></pre></td></tr></table></figure>
<ul>
<li>应用主类使用@EnableZuulProxy注解开启Zuul</li>
</ul>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div><div class="line">6</div><div class="line">7</div></pre></td><td class="code"><pre><div class="line">@EnableZuulProxy</div><div class="line">@SpringCloudApplication</div><div class="line">public class Application &#123;</div><div class="line">	public static void main(String[] args) &#123;</div><div class="line">		new SpringApplicationBuilder(Application.class).web(true).run(args);</div><div class="line">	&#125;</div><div class="line">&#125;</div></pre></td></tr></table></figure>
<p>这里用了@SpringCloudApplication注解，之前没有提过，通过源码我们看到，它整合了@SpringBootApplication、@EnableDiscoveryClient、@EnableCircuitBreaker，主要目的还是简化配置。这几个注解的具体作用这里就不做详细介绍了，之前的文章已经都介绍过。</p>
<ul>
<li>application.properties中配置Zuul应用的基础信息，如：应用名、服务端口等。</li>
</ul>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div></pre></td><td class="code"><pre><div class="line">spring.application.name=api-gateway</div><div class="line">server.port=5555</div></pre></td></tr></table></figure>
<p>==配置完，服务网关就可以启动了，重点来了，问题二==</p>
<h3 id="问题2：Zuul服务路由组件两种url映射关系配置"><a href="#问题2：Zuul服务路由组件两种url映射关系配置" class="headerlink" title="问题2：Zuul服务路由组件两种url映射关系配置"></a>问题2：Zuul服务路由组件两种url映射关系配置</h3><p>完成上面的工作后，Zuul已经可以运行了，但是如何让它为我们的微服务集群服务，还需要我们另行配置，下面详细的介绍一些常用配置内容。</p>
<ul>
<li>服务路由</li>
</ul>
<p>通过服务路由的功能，我们在对外提供服务的时候，只需要通过暴露Zuul中配置的调用地址就可以让调用方统一的来访问我们的服务，而不需要了解具体提供服务的主机信息了。</p>
<p>在Zuul中提供了两种映射方式：</p>
<ul>
<li>2.1通过url直接映射，我们可以如下配置：</li>
</ul>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div><div class="line">6</div><div class="line">7</div><div class="line">8</div></pre></td><td class="code"><pre><div class="line"># routes to url 当url地址是/api-a-url/**，会自动路由到端口2222的服务上</div><div class="line">zuul.routes.api-a-url.path=/api-a-url/**</div><div class="line">zuul.routes.api-a-url.url=http://localhost:2222/</div><div class="line"># routes to url 当url地址是/api-a-url/**，会自动路由到端口2222的服务上</div><div class="line">zuul.routes.api-b-url.path=/api-b-url/**</div><div class="line">zuul.routes.api-b-url.url=http://localhost:2223/</div><div class="line"></div><div class="line"># 其中zuul.routes.&#123;自定义&#125;.url|path</div></pre></td></tr></table></figure>
<ul>
<li>2.2通过ServiceID映射，我们可以如下配置：</li>
</ul>
<p>通过url映射的方式对于Zuul来说，并不是特别友好，Zuul需要知道我们所有为服务的地址，才能完成所有的映射配置。而实际上，我们在实现微服务架构时，服务名与服务实例地址的关系在eureka server中已经存在了，所以只需要将Zuul注册到eureka server上去发现其他服务，我们就可以实现对serviceId的映射。例如，我们可以如下配置：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div><div class="line">6</div></pre></td><td class="code"><pre><div class="line">#service-A/service-B是注册到服务器上的Service服务名</div><div class="line">zuul.routes.api-a.path=/api-a/**</div><div class="line">zuul.routes.api-a.serviceId=service-A</div><div class="line">zuul.routes.api-b.path=/api-b/**</div><div class="line">zuul.routes.api-b.serviceId=service-B</div><div class="line">eureka.client.serviceUrl.defaultZone=http://localhost:1111/eureka/</div></pre></td></tr></table></figure>
<p><img src="http://upload-images.jianshu.io/upload_images/4279695-0923d03d83d4beab.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" alt=""></p>
<p>尝试通过服务网关来访问service-A和service-B，根据配置的映射关系，分别访问下面的url</p>
<ul>
<li><a href="http://localhost:5555/api-a/add?a=1&amp;b=2：通过serviceId映射访问service-A中的add服务" target="_blank" rel="external">http://localhost:5555/api-a/add?a=1&amp;b=2：通过serviceId映射访问service-A中的add服务</a></li>
<li><a href="http://localhost:5555/api-b/add?a=1&amp;b=2：通过serviceId映射访问service-B中的add服务" target="_blank" rel="external">http://localhost:5555/api-b/add?a=1&amp;b=2：通过serviceId映射访问service-B中的add服务</a></li>
<li><a href="http://localhost:5555/api-a-url/add?a=1&amp;b=2：通过url映射访问service-A中的add服务" target="_blank" rel="external">http://localhost:5555/api-a-url/add?a=1&amp;b=2：通过url映射访问service-A中的add服务</a></li>
</ul>
<p>推荐使用serviceId的映射方式，除了对Zuul维护上更加友好之外，serviceId映射方式还支持了断路器，对于服务故障的情况下，可以有效的防止故障蔓延到服务网关上而影响整个系统的对外服务</p>
<h3 id="问题3：如何对路由服务器进行安全过滤措施"><a href="#问题3：如何对路由服务器进行安全过滤措施" class="headerlink" title="问题3：如何对路由服务器进行安全过滤措施"></a>问题3：如何对路由服务器进行安全过滤措施</h3><ul>
<li>服务过滤</li>
</ul>
<p>在完成了服务路由之后，我们对外开放服务还需要一些安全措施来保护客户端只能访问它应该访问到的资源。所以我们需要利用Zuul的过滤器来实现我们对外服务的安全控制。</p>
<p>在服务网关中定义过滤器只需要继承ZuulFilter抽象类实现其定义的四个抽象函数就可对请求进行拦截与过滤。</p>
<p>比如下面的例子，定义了一个Zuul过滤器，实现了在请求被路由之前检查请求中是否有accessToken参数，若有就进行路由，若没有就拒绝访问，返回401 Unauthorized错误。</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div><div class="line">6</div><div class="line">7</div><div class="line">8</div><div class="line">9</div><div class="line">10</div><div class="line">11</div><div class="line">12</div><div class="line">13</div><div class="line">14</div><div class="line">15</div><div class="line">16</div><div class="line">17</div><div class="line">18</div><div class="line">19</div><div class="line">20</div><div class="line">21</div><div class="line">22</div><div class="line">23</div><div class="line">24</div><div class="line">25</div><div class="line">26</div><div class="line">27</div><div class="line">28</div><div class="line">29</div><div class="line">30</div></pre></td><td class="code"><pre><div class="line">public class AccessFilter extends ZuulFilter  &#123;</div><div class="line">    private static Logger log = LoggerFactory.getLogger(AccessFilter.class);</div><div class="line">    @Override</div><div class="line">    public String filterType() &#123;</div><div class="line">        return &quot;pre&quot;;</div><div class="line">    &#125;</div><div class="line">    @Override</div><div class="line">    public int filterOrder() &#123;</div><div class="line">        return 0;</div><div class="line">    &#125;</div><div class="line">    @Override</div><div class="line">    public boolean shouldFilter() &#123;</div><div class="line">        return true;</div><div class="line">    &#125;</div><div class="line">    @Override</div><div class="line">    public Object run() &#123;</div><div class="line">        RequestContext ctx = RequestContext.getCurrentContext();</div><div class="line">        HttpServletRequest request = ctx.getRequest();</div><div class="line">        log.info(String.format(&quot;%s request to %s&quot;, request.getMethod(), request.getRequestURL().toString()));</div><div class="line">        Object accessToken = request.getParameter(&quot;accessToken&quot;);</div><div class="line">        if(accessToken == null) &#123;</div><div class="line">            log.warn(&quot;access token is empty&quot;);</div><div class="line">            ctx.setSendZuulResponse(false);</div><div class="line">            ctx.setResponseStatusCode(401);</div><div class="line">            return null;</div><div class="line">        &#125;</div><div class="line">        log.info(&quot;access token ok&quot;);</div><div class="line">        return null;</div><div class="line">    &#125;</div><div class="line">&#125;</div></pre></td></tr></table></figure>
<p>自定义过滤器的实现，需要继承ZuulFilter，需要重写实现下面四个方法：</p>
<ul>
<li>filterType：返回一个字符串代表过滤器的类型，在zuul中定义了四种不同生命周期的过滤器类型，具体如下：<ul>
<li>pre：可以在请求被路由之前调用</li>
<li>routing：在路由请求时候被调用</li>
<li>post：在routing和error过滤器之后被调用</li>
<li>error：处理请求时发生错误时被调用</li>
</ul>
</li>
<li>filterOrder：通过int值来定义过滤器的执行顺序</li>
<li>shouldFilter：返回一个boolean类型来判断该过滤器是否要执行，所以通过此函数可实现过滤器的开关。在上例中，我们直接返回true，所以该过滤器总是生效。</li>
<li>run：过滤器的具体逻辑。需要注意，这里我们通过ctx.setSendZuulResponse(false)令zuul过滤该请求，不对其进行路由，然后通过ctx.setResponseStatusCode(401)设置了其返回的错误码，当然我们也可以进一步优化我们的返回，比如，通过ctx.setResponseBody(body)对返回body内容进行编辑等。</li>
</ul>
<p>在实现了自定义过滤器之后，还需要实例化该过滤器才能生效，我们只需要在应用主类中增加如下内容：</p>
<figure class="highlight plain"><table><tr><td class="gutter"><pre><div class="line">1</div><div class="line">2</div><div class="line">3</div><div class="line">4</div><div class="line">5</div><div class="line">6</div><div class="line">7</div><div class="line">8</div><div class="line">9</div><div class="line">10</div><div class="line">11</div></pre></td><td class="code"><pre><div class="line">@EnableZuulProxy</div><div class="line">@SpringCloudApplication</div><div class="line">public class Application &#123;</div><div class="line">	public static void main(String[] args) &#123;</div><div class="line">		new SpringApplicationBuilder(Application.class).web(true).run(args);</div><div class="line">	&#125;</div><div class="line">	@Bean</div><div class="line">	public AccessFilter accessFilter() &#123;</div><div class="line">		return new AccessFilter();</div><div class="line">	&#125;</div><div class="line">&#125;</div></pre></td></tr></table></figure>
<p>启动该服务网关后，访问：</p>
<ul>
<li><a href="http://localhost:5555/api-a/add?a=1&amp;b=2：返回401错误" target="_blank" rel="external">http://localhost:5555/api-a/add?a=1&amp;b=2：返回401错误</a></li>
<li><a href="http://localhost:5555/api-a/add?a=1&amp;b=2&amp;accessToken=token：正确路由到server-A，并返回计算内容" target="_blank" rel="external">http://localhost:5555/api-a/add?a=1&amp;b=2&amp;accessToken=token：正确路由到server-A，并返回计算内容</a></li>
</ul>
<p>下面是过滤器的声明周期图<br><img src="http://upload-images.jianshu.io/upload_images/4279695-ae97a701c1bcc936.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" alt=""></p>
<p>最后，总结一下为什么服务网关是微服务架构的重要部分，是我们必须要去做的原因：</p>
<ul>
<li>不仅仅实现了路由功能来屏蔽诸多服务细节，更实现了服务级别、均衡负载的路由。</li>
<li>实现了接口权限校验与微服务业务逻辑的解耦。通过服务网关中的过滤器，在各生命周期中去校验请求的内容，将原本在对外服务层做的校验前移，保证了微服务的无状态性，同时降低了微服务的测试难度，让服务本身更集中关注业务逻辑的处理。</li>
<li>实现了断路器，不会因为具体微服务的故障而导致服务网关的阻塞，依然可以对外服务。</li>
</ul>

        
        </div>
        <footer class="article-footer">
            <div class="share-container">



</div>

    <a data-url="http://yoursite.com/2017/01/11/Spring Cloud系列五 之 服务网关/" data-id="cizk115ck000njj8zwk0srido" class="article-share-link"><i class="fa fa-share"></i>分享到</a>
<script>
    (function ($) {
        // Prevent duplicate binding
        if (typeof(__SHARE_BUTTON_BINDED__) === 'undefined' || !__SHARE_BUTTON_BINDED__) {
            __SHARE_BUTTON_BINDED__ = true;
        } else {
            return;
        }
        $('body').on('click', function() {
            $('.article-share-box.on').removeClass('on');
        }).on('click', '.article-share-link', function(e) {
            e.stopPropagation();

            var $this = $(this),
                url = $this.attr('data-url'),
                encodedUrl = encodeURIComponent(url),
                id = 'article-share-box-' + $this.attr('data-id'),
                offset = $this.offset(),
                box;

            if ($('#' + id).length) {
                box = $('#' + id);

                if (box.hasClass('on')){
                    box.removeClass('on');
                    return;
                }
            } else {
                var html = [
                    '<div id="' + id + '" class="article-share-box">',
                        '<input class="article-share-input" value="' + url + '">',
                        '<div class="article-share-links">',
                            '<a href="https://twitter.com/intent/tweet?url=' + encodedUrl + '" class="fa fa-twitter article-share-twitter" target="_blank" title="Twitter"></a>',
                            '<a href="https://www.facebook.com/sharer.php?u=' + encodedUrl + '" class="fa fa-facebook article-share-facebook" target="_blank" title="Facebook"></a>',
                            '<a href="http://pinterest.com/pin/create/button/?url=' + encodedUrl + '" class="fa fa-pinterest article-share-pinterest" target="_blank" title="Pinterest"></a>',
                            '<a href="https://plus.google.com/share?url=' + encodedUrl + '" class="fa fa-google article-share-google" target="_blank" title="Google+"></a>',
                        '</div>',
                    '</div>'
                ].join('');

              box = $(html);

              $('body').append(box);
            }

            $('.article-share-box.on').hide();

            box.css({
                top: offset.top + 25,
                left: offset.left
            }).addClass('on');

        }).on('click', '.article-share-box', function (e) {
            e.stopPropagation();
        }).on('click', '.article-share-box-input', function () {
            $(this).select();
        }).on('click', '.article-share-box-link', function (e) {
            e.preventDefault();
            e.stopPropagation();

            window.open(this.href, 'article-share-box-window-' + Date.now(), 'width=500,height=450');
        });
    })(jQuery);
</script>

            
    
        <a href="http://yoursite.com/2017/01/11/Spring Cloud系列五 之 服务网关/#comments" class="article-comment-link ds-thread-count" data-thread-key="http://yoursite.com/2017/01/11/Spring Cloud系列五 之 服务网关/">评论</a>
    

        </footer>
    </div>
    
        
<nav id="article-nav">
    
        <a href="/2017/01/27/浅谈分布式与集群(未完待续)/" id="article-nav-newer" class="article-nav-link-wrap">
            <strong class="article-nav-caption">上一篇</strong>
            <div class="article-nav-title">
                
                    浅谈分布式与集群(未完待续)
                
            </div>
        </a>
    
    
        <a href="/2016/12/21/Spring Cloud系列四 之 配置信息Server/" id="article-nav-older" class="article-nav-link-wrap">
            <strong class="article-nav-caption">下一篇</strong>
            <div class="article-nav-title">Spring Cloud系列四 之 配置信息Server</div>
        </a>
    
</nav>


    
</article>


    
    <section id="comments">
    
        
    <div class="ds-thread" data-thread-key="2017/01/11/Spring Cloud系列五 之 服务网关/" data-title="Spring Cloud系列五 之 服务网关" data-url="http://yoursite.com/2017/01/11/Spring Cloud系列五 之 服务网关/"></div>
    <style>
        #ds-thread #ds-reset .ds-textarea-wrapper {
            background: none;
        }
        #ds-reset .ds-avatar img {
            box-shadow: none;
        }
        #ds-reset .ds-gradient-bg {
            background: #f7f7f7;
        }
        #ds-thread #ds-reset li.ds-tab a {
            border-radius: 3px;
        }
        #ds-thread #ds-reset .ds-post-button {
            color: white;
            border: none;
            box-shadow: none;
            background: #d32;
            text-shadow: none;
            font-weight: normal;
            font-family: 'Microsoft Yahei';
        }
        #ds-thread #ds-reset .ds-post-button:hover {
            color: white;
            background: #DE594C;
        }
        #ds-thread #ds-reset .ds-post-button:active {
            background: #d32;
        }
        #ds-smilies-tooltip ul.ds-smilies-tabs li a.ds-current {
            color: white;
            background: #d32;
            box-shadow: none;
            text-shadow: none;
            font-weight: normal;
        }
    </style>

    
    </section>

</section>
            
                <aside id="sidebar">
   
        
    <div class="widget-wrap">
        <h3 class="widget-title">最新文章</h3>
        <div class="widget">
            <ul id="recent-post" class="">
                
                    <li>
                        
                        <div class="item-thumbnail">
                            <a href="/2017/05/17/CPU-bound(计算密集型) 和IO bound(IO密集型)、进程vs线程/" class="thumbnail">
    
    
        <span class="thumbnail-image thumbnail-none"></span>
    
</a>

                        </div>
                        
                        <div class="item-inner">
                            <p class="item-category"><a class="article-category-link" href="/categories/服务器/">服务器</a></p>
                            <p class="item-title"><a href="/2017/05/17/CPU-bound(计算密集型) 和IO bound(IO密集型)、进程vs线程/" class="title">CPU-bound(计算密集型) 和IO bound(IO密集型)、进程vs线程</a></p>
                            <p class="item-date"><time datetime="2017-05-16T16:00:00.000Z" itemprop="datePublished">2017-05-17</time></p>
                        </div>
                    </li>
                
                    <li>
                        
                        <div class="item-thumbnail">
                            <a href="/2017/04/27/Spring Boot中使用@Async实现异步调用/" class="thumbnail">
    
    
        <span class="thumbnail-image thumbnail-none"></span>
    
</a>

                        </div>
                        
                        <div class="item-inner">
                            <p class="item-category"><a class="article-category-link" href="/categories/Spring-Boot实战/">Spring Boot实战</a></p>
                            <p class="item-title"><a href="/2017/04/27/Spring Boot中使用@Async实现异步调用/" class="title">Spring Boot中使用@Async实现异步调用</a></p>
                            <p class="item-date"><time datetime="2017-04-26T16:00:00.000Z" itemprop="datePublished">2017-04-27</time></p>
                        </div>
                    </li>
                
                    <li>
                        
                        <div class="item-thumbnail">
                            <a href="/2017/01/28/线程数究竟设多少合理/" class="thumbnail">
    
    
        <span class="thumbnail-image thumbnail-none"></span>
    
</a>

                        </div>
                        
                        <div class="item-inner">
                            <p class="item-category"><a class="article-category-link" href="/categories/服务器/">服务器</a></p>
                            <p class="item-title"><a href="/2017/01/28/线程数究竟设多少合理/" class="title">线程数究竟设多少合理</a></p>
                            <p class="item-date"><time datetime="2017-01-27T16:00:00.000Z" itemprop="datePublished">2017-01-28</time></p>
                        </div>
                    </li>
                
                    <li>
                        
                        <div class="item-thumbnail">
                            <a href="/2017/01/27/浅谈分布式与集群(未完待续)/" class="thumbnail">
    
    
        <span class="thumbnail-image thumbnail-none"></span>
    
</a>

                        </div>
                        
                        <div class="item-inner">
                            <p class="item-category"><a class="article-category-link" href="/categories/系统架构/">系统架构</a></p>
                            <p class="item-title"><a href="/2017/01/27/浅谈分布式与集群(未完待续)/" class="title">浅谈分布式与集群(未完待续)</a></p>
                            <p class="item-date"><time datetime="2017-01-26T16:00:00.000Z" itemprop="datePublished">2017-01-27</time></p>
                        </div>
                    </li>
                
                    <li>
                        
                        <div class="item-thumbnail">
                            <a href="/2017/01/11/Spring Cloud系列五 之 服务网关/" class="thumbnail">
    
    
        <span class="thumbnail-image thumbnail-none"></span>
    
</a>

                        </div>
                        
                        <div class="item-inner">
                            <p class="item-category"><a class="article-category-link" href="/categories/Spring-Cloud/">Spring Cloud</a></p>
                            <p class="item-title"><a href="/2017/01/11/Spring Cloud系列五 之 服务网关/" class="title">Spring Cloud系列五 之 服务网关</a></p>
                            <p class="item-date"><time datetime="2017-01-10T16:00:00.000Z" itemprop="datePublished">2017-01-11</time></p>
                        </div>
                    </li>
                
            </ul>
        </div>
    </div>

    
        
    <div class="widget-wrap">
        <h3 class="widget-title">分类</h3>
        <div class="widget">
            <ul class="category-list"><li class="category-list-item"><a class="category-list-link" href="/categories/Java命名规范/">Java命名规范</a><span class="category-list-count">1</span></li><li class="category-list-item"><a class="category-list-link" href="/categories/Spring-Boot实战/">Spring Boot实战</a><span class="category-list-count">13</span></li><li class="category-list-item"><a class="category-list-link" href="/categories/Spring-Cloud/">Spring Cloud</a><span class="category-list-count">6</span></li><li class="category-list-item"><a class="category-list-link" href="/categories/服务器/">服务器</a><span class="category-list-count">2</span></li><li class="category-list-item"><a class="category-list-link" href="/categories/服务器搭建/">服务器搭建</a><span class="category-list-count">2</span></li><li class="category-list-item"><a class="category-list-link" href="/categories/系统架构/">系统架构</a><span class="category-list-count">1</span></li></ul>
        </div>
    </div>

    
        
    <div class="widget-wrap">
        <h3 class="widget-title">归档</h3>
        <div class="widget">
            <ul class="archive-list"><li class="archive-list-item"><a class="archive-list-link" href="/archives/2017/05/">五月 2017</a><span class="archive-list-count">1</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2017/04/">四月 2017</a><span class="archive-list-count">1</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2017/01/">一月 2017</a><span class="archive-list-count">3</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/12/">十二月 2016</a><span class="archive-list-count">3</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/11/">十一月 2016</a><span class="archive-list-count">1</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/10/">十月 2016</a><span class="archive-list-count">1</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/08/">八月 2016</a><span class="archive-list-count">5</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/07/">七月 2016</a><span class="archive-list-count">2</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/06/">六月 2016</a><span class="archive-list-count">2</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/05/">五月 2016</a><span class="archive-list-count">2</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2016/01/">一月 2016</a><span class="archive-list-count">3</span></li><li class="archive-list-item"><a class="archive-list-link" href="/archives/2015/01/">一月 2015</a><span class="archive-list-count">1</span></li></ul>
        </div>
    </div>

    
        
    <div class="widget-wrap">
        <h3 class="widget-title">标签</h3>
        <div class="widget">
            <ul class="tag-list"><li class="tag-list-item"><a class="tag-list-link" href="/tags/Java命名规范/">Java命名规范</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/Maven/">Maven</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/Spring-Boot中使用-Async实现异步调用/">Spring Boot中使用@Async实现异步调用</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/Spring-Boot注解/">Spring Boot注解</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/Spring-Cloud/">Spring Cloud</a><span class="tag-list-count">6</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/SpringBoot原生定时任务解析/">SpringBoot原生定时任务解析</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/SpringBoot在启动类配置端口号/">SpringBoot在启动类配置端口号</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/SpringBoot拦截器/">SpringBoot拦截器</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/SpringBoot配置视图/">SpringBoot配置视图</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/Spring整合Quartz2-1-1/">Spring整合Quartz2.1.1</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/优化方案/">优化方案</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/分布式与集群/">分布式与集群</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/动态读取任务执行/">动态读取任务执行</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/启动环境/">启动环境</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/整合定时任务/">整合定时任务</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/服务器/">服务器</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/服务器搭建/">服务器搭建</a><span class="tag-list-count">2</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/计算/">计算</a><span class="tag-list-count">1</span></li><li class="tag-list-item"><a class="tag-list-link" href="/tags/配置文件加载/">配置文件加载</a><span class="tag-list-count">1</span></li></ul>
        </div>
    </div>

    
        
    <div class="widget-wrap">
        <h3 class="widget-title">标签云</h3>
        <div class="widget tagcloud">
            <a href="/tags/Java命名规范/" style="font-size: 10px;">Java命名规范</a> <a href="/tags/Maven/" style="font-size: 10px;">Maven</a> <a href="/tags/Spring-Boot中使用-Async实现异步调用/" style="font-size: 10px;">Spring Boot中使用@Async实现异步调用</a> <a href="/tags/Spring-Boot注解/" style="font-size: 10px;">Spring Boot注解</a> <a href="/tags/Spring-Cloud/" style="font-size: 20px;">Spring Cloud</a> <a href="/tags/SpringBoot原生定时任务解析/" style="font-size: 10px;">SpringBoot原生定时任务解析</a> <a href="/tags/SpringBoot在启动类配置端口号/" style="font-size: 10px;">SpringBoot在启动类配置端口号</a> <a href="/tags/SpringBoot拦截器/" style="font-size: 10px;">SpringBoot拦截器</a> <a href="/tags/SpringBoot配置视图/" style="font-size: 10px;">SpringBoot配置视图</a> <a href="/tags/Spring整合Quartz2-1-1/" style="font-size: 10px;">Spring整合Quartz2.1.1</a> <a href="/tags/优化方案/" style="font-size: 10px;">优化方案</a> <a href="/tags/分布式与集群/" style="font-size: 10px;">分布式与集群</a> <a href="/tags/动态读取任务执行/" style="font-size: 10px;">动态读取任务执行</a> <a href="/tags/启动环境/" style="font-size: 10px;">启动环境</a> <a href="/tags/整合定时任务/" style="font-size: 10px;">整合定时任务</a> <a href="/tags/服务器/" style="font-size: 10px;">服务器</a> <a href="/tags/服务器搭建/" style="font-size: 15px;">服务器搭建</a> <a href="/tags/计算/" style="font-size: 10px;">计算</a> <a href="/tags/配置文件加载/" style="font-size: 10px;">配置文件加载</a>
        </div>
    </div>

    
        
    <div class="widget-wrap widget-list">
        <h3 class="widget-title">链接</h3>
        <div class="widget">
            <ul>
                
                    <li>
                        <a href="http://www.jianshu.com/u/e210c8fa704f">简书</a>
                    </li>
                
                    <li>
                        <a href="http://blog.csdn.net/message_lx/article/details/56674087">CSDN</a>
                    </li>
                
                    <li>
                        <a href="https://www.zhihu.com/people/chinesszz/activities">知乎</a>
                    </li>
                
                    <li>
                        <a href="https://my.oschina.net/chinesszz/blog">开源中国</a>
                    </li>
                
                    <li>
                        <a href="https://lxchinesszz.github.io/">GITHUB博客</a>
                    </li>
                
            </ul>
        </div>
    </div>


    
    <div id="toTop" class="fa fa-angle-up"></div>
</aside>
            
        </div>
        <footer id="footer">
    <div class="outer">
        <div id="footer-info" class="inner">
            &copy; 2017<br>
            <a href="http://www.jianshu.com/u/e210c8fa704f" target="_blank">简书</a>. by <a href="https://github.com/lxchinesszz">Liuxin</a>
        </div>
    </div>
</footer>
        
    
    <script type="text/javascript">
    var duoshuoQuery = {short_name:'lxchinesszz'};
    (function() {
    var ds = document.createElement('script');
    ds.type = 'text/javascript';ds.async = true;
    ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js';
    ds.charset = 'UTF-8';
    (document.getElementsByTagName('head')[0]
    || document.getElementsByTagName('body')[0]).appendChild(ds);
    })();
    </script>



    
        <script src="/libs/lightgallery/js/lightgallery.min.js"></script>
        <script src="/libs/lightgallery/js/lg-thumbnail.min.js"></script>
        <script src="/libs/lightgallery/js/lg-pager.min.js"></script>
        <script src="/libs/lightgallery/js/lg-autoplay.min.js"></script>
        <script src="/libs/lightgallery/js/lg-fullscreen.min.js"></script>
        <script src="/libs/lightgallery/js/lg-zoom.min.js"></script>
        <script src="/libs/lightgallery/js/lg-hash.min.js"></script>
        <script src="/libs/lightgallery/js/lg-share.min.js"></script>
        <script src="/libs/lightgallery/js/lg-video.min.js"></script>
    
    
        <script src="/libs/justified-gallery/jquery.justifiedGallery.min.js"></script>
    



<!-- Custom Scripts -->
<script src="/js/main.js"></script>

    </div>
</body>
</html>